Replacing template objects on the folder page
The right-hand side of the Container tab folder shows a grid. The visual grid acts as placeholder for the relative layout of objects like toolbars, browses, and viewers. The nonvisual grid acts as a placeholder for data sources like SDOs and SBOs. As shown in the grid, the window has three visual objects, two toolbars and a template object for a dynamic browse. Template objects are nonfunctional place holders that must be replaced by actual objects. It also has one nonvisual object, an SDO template object. You replace these templates with actual objects to retrieve and display data from the database.
|
To replace the template objects with your application objects: |
- Choose the Show all visual objects button
in the Container folder. - Choose rytemfullb, the browse template object
, in the grid. The Instance information displays the data for the object. - Choose the Lookup icon
beside the Object field. The Object Lookup dialog box appears, filtered to show only browses: - Double-click armcufullb, the customer browse, to select it. The Container Builder automatically substitutes the customer browse for the browse template object. (This is a temporary change until you save your work to the Repository.) You automatically return to the Container Builder window.
- Type CustomerBrowse as the Name for this instance of the
armcufullbbrowse. - Choose the Dynamic Properties button
on the folder’s object instance toolbar. The object instance toolbar is the one inside the folder. The toolbar at the top of the window is the container toolbar. The Dynamic Properties sheet for the browse appears: - Type oeCustFoldWin for the FolderWindowToLaunch attribute. This is the Customer Maintenance window you will build in the "Creating folder windows" section. It will launch whenever a user chooses a record to edit from the Customer browse window.
- Close the property sheet. The property value is saved temporarily. The change is not saved permanently until you save the container.
- Choose the Show all non-visual objects button
in the Container folder. The grid now shows the template’s SDO: - Choose the Lookup button next to the Object field. The Object Lookup dialog box appears, filtered to show only SDOs:
- Double-click armcufullo, the customer SDO, to select it. You automatically return to the Container Builder, and the following message dialog box appears:
- Choose OK to continue.
- Type CustomerSDO as the Name for this instance of the armcufullo SDO.
- Choose the Links Maintenance button
in the container toolbar. The Links Maintenance dialog box appears: - Verify that the following links are defined for the objects on the oeCustBrowseWin window. Click on the Source column header to sort the links:
- Exit the Links Maintenance dialog box.
- Choose Save, and exit the Container Builder.
The SDO template object is a static object. The customer SDO is a dynamic object. The framework recognizes that these are different object types. This message reminds you that different objects might not have all the same attributes and behavior changes might result. In this case, it does not matter because the template was designed so either a dynamic or static SDO could replace it.
SmartObjects communicate through named connections called OpenEdge SmartLinks™. A SmartLink is a two-way association of two SmartObjects. The link type establishes how the SmartObjects relate to each other and what actions to expect from the other. Simply by naming the source and target objects and the link type, you enable the AppBuilder to set up the channels the objects need to communicate. See OpenEdge Development: Progress Dynamics Basic Development for more information on SmartLinks.
The links you see are defined in the template container. When you replaced the template objects with your application objects, the Container Builder automatically updated the links to use your objects.
THIS-OBJECT refers to the container, oeCustBrowseWin.